/**
 * Copyright 2006 gworks.com.au
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License. (http://www.apache.org/licenses/LICENSE-2.0)
 *
 * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed 
 * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for 
 * the specific language governing permissions and limitations under the License.
 *
 * <dhamma-message src="Atisha (11th century Tibetan Buddhist master)">
 * 	The greatest achievement is selflessness. The greatest worth is self-mastery.
 * 	The greatest quality is seeking to serve others. The greatest precept is continual awareness.
 * 	The greatest medicine is the emptiness of everything. The greatest action is not conforming with the worlds ways.
 * 	The greatest magic is transmuting the passions. The greatest generosity is non-attachment.
 * 	The greatest goodness is a peaceful mind. The greatest patience is humility.
 * 	The greatest effort is not concerned with results. The greatest meditation is a mind that lets go.
 * 	The greatest wisdom is seeing through appearances. 
 * </dhamma-message>
 */
package org.javaongems.client.rt.text.dom;

import com.google.gwt.user.client.DOM;
import com.google.gwt.user.client.Element;
import com.google.gwt.user.client.ui.UIObject;

/**
 * <p>Provide extension utilities for the GWT UIObject class.</p>
 * <p>Responsibilities:
 * <ul>
 * 	<li> expose reusable functionality that is otherwise hidden inside 
 * 		the UIObject class and only accessible by adding to that namespace
 * </ul>
 * </p>
 * @author Ashin Wimalajeewa (ash)
 */
public class UiObjectExtUtils extends UIObject {
	  public static void setStyleName(Element elem, String style, boolean add) {
		  UIObject.setStyleName(elem, style, add);
	  }
	  
	  /**
	   * Sets the position of the specified element. Setting a position of
	   * <code>(-1, -1)</code> will cause the element to be positioned
	   * statically.
	   * 
	   * @param w the child widget to be positioned
	   * @param left the widget's left position
	   * @param top the widget's top position
	   */
	  public void setWidgetPosition(Element h, int left, int top) {
	    if ((left == -1) && (top == -1)) {
	      DOM.setStyleAttribute(h, "left", "");
	      DOM.setStyleAttribute(h, "top", "");
	      DOM.setStyleAttribute(h, "position", "static");
	    } else {
	      DOM.setStyleAttribute(h, "position", "absolute");
	      DOM.setStyleAttribute(h, "left", left + "px");
	      DOM.setStyleAttribute(h, "top", top + "px");
	    }
	  }
}
